xcol

Section: User Commands (1)
Updated: 5 March 1990
Index Return to Main Contents

NAME

xcol - change color-entries in textfiles

SYNOPSIS

xcol [-options ...] [filename]

DESCRIPTION

XCol displays the colors defined in the rgb.txt-file of the XServer. The colors are sorted by their names and their RGB-values and shown in a cube in the ColorView-Window (The positions represent the RGB-values). Since there usually are more colors defined in the file than cells in the colormap, entries with the same name but different RGB-values for different intensities, are grouped together.

If a filename is given as a parameter, all occurrences of color-names in that file are shown in an additional TextView-Window. To change the colors, a text-line has to be made active. Afterwards a new color can be selected in the ColorView-Window. To get a better impression of the color, a help-color (background) can be selected for each text-line. If 2 lines define a foreground and a background color, an association can be made and the colors of both lines can be selected together.

BUTTONS

in ColorView-Window

left:: select color for the active line.
middle:: select help-color for the active line.
right:: warp pointer to color of active line.

in TextView-Window

left:: select line as active line.
middle:: toggle reverse-mode or
: connect/disconnect 2 lines.
right:: show line in the textfile.

OPTIONS

-rv: Color-positions are reversed in the cube. Some new colors can become visible in the area of the very bright colors.
-b<n>: The size of color blocks is set to the constant <n>. By default, it depends on the size of the ColorView-Window.
-gran<n>: The maximum number of associated colors is set to <n>. By default, this value is 11. (You can see the effect when reaching the grey-field, where 101 associated entries are possibly available.)
-dark<n>: The percentage of the intensity of other colors can be set (default: 50). It is easier to select a color, if the screen is darkened a little bit.
+<char_list>: add characters to list of 'space'-chars. The color-string in the textfile has to occur between 2 'space'-chars to be recognized. By default, these letters are ' ', '\t', '\n', ':', '"'.
-strings: Names of colors in the file are only recognized when used in a string (useful for C-Sources). This means that the list of 'space'-chars is set to '"' only.
-case: All occurrences of color-names in wrong case are replaced by the color-name of the 'rgb.txt'-file.
-help: print some instructions (usage of buttons).
-file <name>: name of a different 'rgb.txt'-file.

FILES

/usr/lib/X11/rgb.txt

BUGS

Actually I wanted the program to work with the selection mechanism used in xterm (when no textfile is given), but it seems to be too complicated to use it here. So, the current version always stores the string of the color in CUT_BUFFER0. If anyone has an easy way to use the correct selection mechanism, please inform me.

COPYRIGHT

Author: Helmut Hoenig (hoenig@informatik.uni-kl.de)

Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies.

This document was created by man2html, using the manual pages.
Time: 11:28:40 GMT, February 07, 2023